| Davar4: MDK - Preparation of book modules |
|
Book modules are modules, which have structure similar to Bible, i.e. division to book-chapter-verse.
For simple texts (without tags), it is relatively easy to prepare input data.txt file from different sources. You can use, for example text from online internet Bibles or exports from various biblical programs.
IMPORTANT RULES:
1) data.txt file contains one verse per line. Each line is finished by Enter (CR+LF characters)
2) There cannot be missing verses or chapters
If you need to insert new paragraph into verse, use |C tag
If your text has missing verse, use some neutral text e.g. "---" and fill correctly reference.
Example of data.txt file:
|
; this is note
|
; this is note = note, text is ignored if FIRST character is ;
Ge 1:1 = text without tags
Ge 1:2 = text with Hebrew Strong# tags, which are immediately after particular word. E.g. earth|RH776|Rh which means earth has H776. Also used tag for unused word in original |TUwas|Tu
Ge 1:3 = example of missing verse (in original text) and because Davar cannot process missing verses, it has text "---"
Ge 1:4 = example of text with variant |TVthe light from…: Heb. between the light and between the darkness|Tv
IMPORTANT:
1) Names of the books (Ge) are not important for conversion. You can use instead of "Ge" for Genesis also "1" or "ABC" or "Genesis" or "1Moses" or something else - which makes conversion easier. Names of the books, which are included into module are listed in info.txt in section D4_Books= (see below).
2) Conversion program search for pattern some_book_name chapter_number:verse_number text of verse
where important is part chapter_number:verse_number - for detection of reference
and SPACE text of verse finished by new paragraph (CR+LF, this means each verse is finished by Enter)
Last verse of the file is also finished by at least one new paragraph (CR+LF)
3) New book is detected whenever number of chapter and verse is 1. E.g.: Ex 1:1 These are the names of the sons of Israel... is detected as new book because chapter and verse=1.
Example of info.txt file used for KJV+ conversion (blue, bold) , next line (red) is commentary and explanation (not a part of file!). All red commentaries also starts here by ; character - thus you can copy and paste to editor all section below and use it as template for your module.
|
;THIS FILE MUST BE UTF-8, Little Endian, without Byte Order Mark. New line is CR+LF pair ; when ; is used as first character, all line is ignored (user note) D4_OutputFile=kjv+.dbk ; name of the final output module file, kjv+.dbk D4_Version_Major=1 ; major and minor version. Important when you release fixed module versions D4_Abbreviation=KJV+ D4_Title=King James Version Bible D4_Info=King James Version Bible 1611/1768. Include Strongs references and colored Jesus words D4_Copyright=Public domain text D4_URL=
D4_BooksNumber=66 D4_BooksExternNumber=0 ;0=latin book, 1=HE, 2=GR ; as note line describes, it is language of the book. All LeftToRight books are considered as Latin (=0), Hebrew =1, Greek = 2 and books which are not Hebrew but has R2L direction = 3
; if books is only plain text without tags, then use value =0. In cases when at least one tag is used in text, use value =1. ;Here are standard Microsoft values for primary and secondary language of the book ; for sorting of texts, program needs to know MAIN language of the book. Here are standard Microsoft values for languages in hexadecimal form. You will find complete list in D4-specification.txt file in MDK in section Identifier Predefined symbol Language. Some most common values are listed in note. If language of the book has no sublanguage, then use on second line: D4_BookSubLanguage=0x00
;Tag flags: 0=tag not used,1=tag is used and default visible,3=tag is used and default invisible | ;Type of GR morphology:0=none,1=Tauber,2=Robinson,3=Packard ; list of all tags, used in Davar4. Use only values 0 or 1 (rest is not implemented yet). 1= tag is used, 0= tag is not used.
D4_Synchronize=1 D4_ScrollVerses=1 D4_JumpInside=1
D4_Books=
; very important section. This block contains information about all books, which text is a part of module. First line: ;D4_Books= ;is immediately followed by descriptions for each book per line. Number of the lines MUST BE EXACTLY SAME AS THE NUMBER OF THE BOOKS specified before (section D4_Books=). ;Each book on line has following parameters (e.g. 1,OTGen,Genesis,Gen): ;1 =number of the book. From 1 to D4_Books ;OTGen = unique synchronization string for this book (Genesis). You will find complete list in D4-specification.txt file in MDK in section Reserved synchro names. ;Genesis = name of the book, which will be included in module. It means, you can use in data.txt almost any names for books, but this name will be used. ;Gen = abbreviation of the book, which will be used in module.
;If extern books are used, it is in format: ; if external books are used (see above), you can enable this section. It is identical as D4_Books= except first line, where is: D4_BooksExtern= ;Note, extern books are also numbered from 1.
|